home *** CD-ROM | disk | FTP | other *** search
/ Animation / Animation Vol.1 (Profi ROM)(1994).iso / csv / vfd.doc < prev    next >
Text File  |  1994-07-06  |  28KB  |  566 lines
  1.  
  2.                     VFD(tm) Video for DOS Shareware Version
  3.                            Release 1.1b  (07/07/94)
  4.              Copyright (c) 1994 by Bob Williamson  CIS 76570,2752
  5.                
  6.       VFD(tm) is a DOS command-line motion video cross-compiler for creating 
  7.       .FLC, .FLI and .AVI files from:
  8.  
  9.       Windows .DIB files (all BMP & RLE)
  10.       Windows .BMP files (1, 4, 8, 16 & 24-bit)
  11.       Windows .RLE files (4 & 8-bit, including deltas)
  12.       IBM OS/2 .BMP files (1, 4, 8 & 24-bit)
  13.       Truevision .TGA files (8, 16, 24 & 32-bit rle & uncmp)
  14.       CompuServe .GIF files (PC & Mac 87a, 89a)         *registered version*
  15.       Zsoft .PCX files (8 & 24-bit)                     *registered version*
  16.       Autodesk .FLC and .FLI files (all)
  17.       Windows .AVI files (RLE and 8, 16, & 24-bit literals)
  18.       MPEG .RAW files produced by DMPEG.EXE v1.1 (8 & 24-bit)
  19.  
  20.       VFD will extract a numpic file series from .FLC, .FLI, .RAW, and .AVI 
  21.       (RLE & literals only) in .BMP, .RLE, .GIF, .PCX or .TGA formats.   
  22.       Direct conversion of the listed motion video and image formats is also 
  23.       supported.
  24.  
  25.       VFD uses an advanced method of color quantitization called Hilite
  26.       Promotion (Scaleable Adaptive, Histogram-based).  Hilite Promotion 
  27.       produces 8-bit motion video with high color fidelity and image 
  28.       resolution from a diverse range of image files and palettes by using 
  29.       scaleable quantitization (color reduction) and variable dither 
  30.       intensity.  Hilite Promotion can be used to create an optimum palette 
  31.       containing both the most popular colors and the most diverse colors 
  32.       from the input images.
  33.  
  34.       Hilite Promotion was developed as a solution to the motion video color 
  35.       quantitization problem of multiple images and palettes.  It may be 
  36.       used for building compatible Windows identity palettes for two or more 
  37.       bit-mapped images to be displayed by Windows, as well as motion video.
  38.  
  39.       PARAMS:
  40.  
  41.       VFD options may be invoked by use of command-line parameters.  The
  42.       parameters follow the infile, preceded by a space and either a forward 
  43.       slash '/' or a hyphen '-'.  The params may be in any order and are case 
  44.       insensitive.  Typing 'VFD <enter>' will display a list of the options: 
  45.       
  46.   VFD infile [params]
  47.   -I         create .FLI (default is .FLC)
  48.   -An        create .AVI n=1 8-bit literal, n=2 RLE 
  49.   -En        Extract numpic series n=1 8-bit .BMP, n=2 .RLE delta, n=3 .GIF
  50.              n=4 8-bit .PCX, n=5 8-bit .TGA uncmp
  51.   -Sn        playback Speed in frm/sec n=0.1 to 99 (default=15)
  52.   -Ofname    Outpath [d:\path\]fname (default fname=infile w/ outtyp .ext)
  53.   -Tn1[,n2]  Total frames n1=start, n2=total count (disables B2 pingpong)
  54.   -Mn        CoMpression n=1 50%, n=2 67%, n=3 75%, n=4 80%, ..., n=99 99%
  55.   -Kn        Keyframe interval n=1 to 65535 (Default is no keyframes)
  56.   -Bn        Backward n=1, pingpong n=2, mirror n=3 (B1,B2: numpic only)
  57.   -Rn        Resize n=1 1/2, n=2 2x n=3 override dflt FLI aspect correction
  58.   -Cn        Color count n=2 to 255 (default=256)
  59.   -Hn        Hilite promotion (range 1 to 255) (default=256 most pop colors)
  60.   -Dn        Dither (intensity range 2 to 255)
  61.   -L±n[,c]   Luminance n=1 to 32 (+ lite, - dark) (c=r,g,b: red,green,blue)
  62.   -Wn        Windows identity palette n=1 mapped, n=2 not mapped
  63.   -Fn        Fixed Windows id pal n=1 256 colr, n=2 gray, n=3 hlftne, n=4 b&w
  64.   -Pn        write Pal n=1 RIFF .PAL, n=2 DIB .PAL, n=3,4 AA,AAPro .COL,
  65.              n=5 PicLab .MAP, n=6 PSP .PAL, n=7 NeoPnt .PAL, n=8 generic .PAL
  66.  
  67.       The infile may be any of the above listed image file formats.  VFD 
  68.       will read a numpic series if wildcards ('*' or '?') are used in the 
  69.       file name. The infile may include the path. The output file path is 
  70.       the current default.  Examples:
  71.  
  72.       VFD pretty00.bmp                     (produce a one frame .FLC
  73.                                            PRETTY.FLC)
  74.  
  75.       VFD pretty*.rle                      (produce a 100 frame .FLC
  76.                                            starting w/ pretty00.rle
  77.                                            thru pretty99.rle named
  78.                                            PRETTY.FLC)
  79.  
  80.       VFD d:\pretty\pretty??.rle -a2 -w1   (produce PRETTY.AVI with a 
  81.                                            Windows identity palette)
  82.  
  83.       VFD pretty.avi -i                    (produce PRETTY.FLI)
  84.                                            
  85.       MAKEFILE:
  86.  
  87.       Typing 'VFD -? <enter>' will display the following:
  88.  
  89.       The infile for VFD may be a text file with the extension of .MAK which 
  90.       lists the source image files and optional keywords.  If a motion video 
  91.       file is used in the makefile, it must be the only input image file.  
  92.       The keywords are: 
  93.       
  94.             REPEAT_n (repeat the previous input file 'n' times)
  95.             PINGPONG (read the previous numpic series in reverse order) 
  96.             BACKWARD (read the following numpic series in reverse order)
  97.             MIRROR_ON (the following frames will be mirror-image)
  98.             MIRROR_OFF (turn mirror-image off)
  99.             KEYFRAME (the following frame will be a keyframe)
  100.             CD-ROM (the AVI video chunks will be padded for CD-ROM playback)
  101.             CROP_n1,n2,n3,n4 (n1=top, n2=left, n3=width, n4=height) zero base
  102.       
  103.       Keywords are not case-sensitive.  The comment character is a semicolon.
  104.  
  105.       Example text of PRETTY.MAK:
  106.                                  ;216 frames, 320x240, identity pal
  107.                                  pretty.pal
  108.                                  d:\pretty\pretty00.bmp
  109.                                  REPEAT_8
  110.                                  d:\pretty\pretty??.bmp
  111.                                  d:\pretty\pretty99.bmp
  112.                                  REPEAT_8
  113.                                  PINGPONG
  114.  
  115.      The above example will produce PRETTY.FLC containing 10 frames of 
  116.      pretty00.bmp, 98 frames of pretty01.bmp thru pretty98.bmp, 10 frames 
  117.      of pretty99.bmp and 98 frames of pretty98.bmp thru pretty01.bmp.  The
  118.      palette file pretty.pal will be used for the motion video palette.
  119.      PINGPONG repeats the previous numpic series in reverse, omitting the 
  120.      first and last frames.  
  121.  
  122.      The maximum frame count is 65535.  The maximum makefile size is 16kb.
  123.      Numpic series with the same base name are limited to a maximum of 8190 
  124.      frames.  VFD reads stdin for response to input prompts.  VFD may be 
  125.      invoked in a batch file (.BAT) using redirection of a text file for 
  126.      input response.  The system date, time and command line params are 
  127.      inserted as the first comment line in the makefile each time the 
  128.      makefile is processed by VFD.  Input image files are opened read-only.
  129.      
  130.      The .MAK extension is not required on the command line.  'VFD pretty' 
  131.      is equivilent to 'VFD pretty.mak'.
  132.  
  133.      HILITE PROMOTION:
  134.       
  135.      Any combination of input image types and color formats (1 to 32 bit) 
  136.      may be combined in a VFD makefile.  If the total color count exceedes 
  137.      256, Hilite Promotion and dither should be used to obtain the optimum 
  138.      output for 8-bit video.  VFD builds a popularity histogram of all the 
  139.      colors from the input images.  The motion video palette consists of the 
  140.      256 most popular colors less the Hilite Promotion value.  The Hilites 
  141.      are then added to the motion video palette from the remaining colors in 
  142.      the histogram.  The Hilites are selected as those colors in the 
  143.      histogram having the greatest difference from the colors already 
  144.      included in the motion video palette.  If the '-Cn' (color count) option 
  145.      is used, the Hilite value is subtracted from the color count.  Black, by 
  146.      default, is always the first color in the motion video palette.
  147.  
  148.      A Hilite value of 255 (true-cut) will produce results similar to the 
  149.      standard unbiased median-cut method of color reduction.  With Hilite 
  150.      pr